home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / bnchutil.arc / DF.DOC < prev    next >
Text File  |  1991-04-30  |  65KB  |  1,291 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                              DF - Directory Freedom 3.50
  10.  
  11.  
  12.                         Copyright 1989, 1990 by Gordon Haff.
  13.                                 All rights reserved.
  14.  
  15.  
  16.  
  17.           Command:  DF
  18.  
  19.           Purpose:  Offer users a fast, compact alternative to DOS Shells
  20.                     which provides 1) selective file and directory
  21.                     operations; 2) a scrollable environment for examining
  22.                     directories; and 3) user-defined keys which can operate
  23.                     upon highlighted files (e.g. defined editors)
  24.  
  25.           Format:   DF [d:][source-path] [d:][dest-path] [/O,N,E,D,or
  26.           S][/F][/V]
  27.  
  28.           Prereqs:  100% IBM Compatible PC running DOS 2.0 or higher
  29.                     (certain directory commands require DOS 3.0 or higher)
  30.  
  31.           Major Associated Programs:
  32.  
  33.                DFCONFIG, while not required for the use of DF, allows for
  34.                     the installation of user-defined commands and options
  35.                     in an intuitive, menu-driven manner.  CONVERT allows
  36.                     users of earlier revisions to preserve their customized
  37.                     options when upgrading.
  38.  
  39.  
  40.                                  ┌─────────┐
  41.                            ┌─────┴───┐     │              (tm)
  42.                          ──│         │o    │──────────────────
  43.                            │   ┌─────┴╨──┐ │  Association of
  44.                            │   │         │─┘  Shareware
  45.                            └───│    o    │    Professionals
  46.                          ──────│    ║    │────────────────────
  47.                                └────╨────┘    MEMBER
  48.  
  49.  
  50.           Directory Freedom 3.50                                     2
  51.  
  52.  
  53.                                      DISCLAIMER
  54.  
  55.           The author hereby disclaims all warranties relating to this
  56.           product, whether express or implied, including without limitation
  57.           any implied warranties of merchantability or fitness for a
  58.           particular purpose. The author cannot and will not be liable for
  59.           any special, incidental, consequential, indirect or similar
  60.           damages due to loss of data or any other reason, even if the
  61.           author or an authorized agent has been advised of the possibility
  62.           of such damages.  In no event shall the liability for any damages
  63.           ever exceed the price paid for the license to use the software,
  64.           regardless of the form and/or extent of the claim.  The user of
  65.           this program bears all risk as to the quality and performance of
  66.           the software.
  67.  
  68.                                        LICENSE
  69.  
  70.           Directory Freedom is a Shareware product.  As such, it is made
  71.           available to the general personal computing public for
  72.           evaluation.  Users are licensed to operate this program on their
  73.           personal computers for the purpose of test and evaluation on a
  74.           trial basis for a limited trial period.  It is not possible to
  75.           reasonably define the limits of a fair and equitable time period
  76.           for evaluation; therefore it is left to the user's judgment and
  77.           sense of fair play as to the time required to make a decision as
  78.           to its usefulness.  If the user decides the program is not of
  79.           sufficient merit to warrant purchase through registration with
  80.           the author, he/she should remove the program from his/her
  81.           personal computer.  Otherwise, if the program is deemed useful
  82.           and is in regular use on the user's computer system, registration
  83.           with the author is required.
  84.  
  85.           Registered users are those users who elect to pay for Directory
  86.           Freedom and register that payment with the author.  By virtue of
  87.           registration and payment for the program, registered users are
  88.           granted a license to continue to utilize the program on their
  89.           personal computer for as long as they choose.  This license
  90.           authorizes the user to use the program on any personal computer
  91.           system he or she may own or use so long as the program is
  92.           operated on only one computer system at a time.
  93.  
  94.                                       GUARANTEE
  95.  
  96.           Directory Freedom is offered with an unconditional 30-day money-
  97.           back guarantee.  If you become unsatisfied with the program for
  98.           any reason within that period, just let me know and your
  99.           registration will be refunded.  If you purchased a registration
  100.           package which included a diskette and a manual, please return
  101.           these when requesting a refund.
  102.  
  103.           This guarantee is unconditional.  I would ask, however, if you
  104.           are having a problem to let me know before giving up on DF since
  105.           your problem may be something I can solve.
  106.  
  107.           Finally, if you order a registration package which includes
  108.  
  109.           Directory Freedom 3.50                                     3
  110.  
  111.           diskette and manual and either of these items are defective --
  112.           either through my error or through postal service "processing",
  113.           let me know and I will send replacements promptly.
  114.  
  115.  
  116.           Directory Freedom 3.50                                     4
  117.  
  118.                                     REGISTRATION
  119.  
  120.           Directory Freedom is the sole property of Gordon Haff.  The
  121.           program may be freely copied and transferred to individual
  122.           parties for evaluation purposes.  It may be posted on Bulletin
  123.           Board systems (BBS) for electronic access as long as NO FEE is
  124.           charged for its distribution except for private BBS operations
  125.           that charge a regular user subscription fee.  Computer
  126.           information services such as Compuserve (CIS), Genie, and Byte
  127.           Information Exchange (BIX) are authorized to post this product
  128.           for subscriber access.  Directory Freedom may be distributed on
  129.           diskette only by 1) disk distributors/vendors who are associate
  130.           members of the Association of Shareware Professionals (ASP) or 2)
  131.           users groups which do not charge more than a nominal fee ($5) to
  132.           cover the costs of distribution.  Any changes to these policies
  133.           must be made in writing by the author.
  134.  
  135.           Directory Freedom is a fully functional Shareware product.
  136.           Shareware is a computer program distribution/marketing method
  137.           that permits potential buyers to thoroughly try the program prior
  138.           to purchase. It is NOT free and it is not in the Public Domain.
  139.           If, after evaluating the program, you find it to be useful enough
  140.           to use it on a regular basis, you are expected to pay for it by
  141.           registering with the author.
  142.  
  143.           The registration fee is $20.00.  The payment of this registration
  144.           fee to the author entitles the user to full use of the product
  145.           for an unlimited period of time in addition to product support.
  146.           The distribution of diskette copies of Directory Freedom and
  147.           future upgrades is not included as part of the basic registration
  148.           fee.  See the order form at the end of this documentation for the
  149.           charges associated with these services.
  150.  
  151.           Attractively-priced site licensing is available for commercial
  152.           users.  Please call or write for details since the pricing varies
  153.           depending upon support and product update requirements.
  154.           Customization is also available on a contract basis.
  155.  
  156.           Please note that the registration fee is specifically limited to
  157.           Directory Freedom (DF.COM), the configuration program
  158.           (DFCONFIG.EXE), and their associated documentation.  Other
  159.           copyrighted "Freeware" and public domain software is distributed
  160.           with Directory Freedom only for the convenience of users.
  161.  
  162.           This program is produced by a member of the Association of
  163.           Shareware Professionals (ASP).  ASP wants to make sure that the
  164.           shareware principle works for you. If you are unable to resolve a
  165.           shareware-related problem with an ASP member by contacting the
  166.           member directly, ASP may be able to help. The ASP Ombudsman can
  167.           help you resolve a dispute or problem with an ASP member, but
  168.           does not provide technical support for members' products. Please
  169.           write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006
  170.           or send a Compuserve message via easyplex to ASP Ombudsman
  171.           70007,3536
  172.  
  173.           Directory Freedom 3.50                                     5
  174.  
  175.                                   TECHNICAL SUPPORT
  176.  
  177.           Full technical support is available to registered users of
  178.           Directory Freedom.  I have found that the most effective product
  179.           support can be delivered through the electronic services listed
  180.           below.  If this option is not open to you, however, I also offer
  181.           full product support through the mails, or, if the problem
  182.           absolutely cannot wait, the telephone (no collect calls please).
  183.           (It's not that I don't want to talk with you, it's just that I
  184.           have found it very difficult to talk through complex problems
  185.           over the telephone.)  I will do my best to resolve any software
  186.           bugs in a timely manner and I am always open to incorporating new
  187.           features or changes which are appropriate to the nature of the
  188.           product.
  189.  
  190.           I will attempt to respond to software trouble reports made by
  191.           non-registered users if the problems affect the general
  192.           functionality of the program.  Such users should not, however,
  193.           expect product support beyond initial aid to determine if the
  194.           program is suitable for their needs.
  195.  
  196.                Contact via:
  197.  
  198.                     Channel 1 BBS            (617) 354-3137
  199.                     Future Technology BBS         (617) 720-3600
  200.                     Compuserve User ID#           72561,2637  (See Note 2)
  201.                     InterNet/ARPANET              See Note 1
  202.                     BIX                      ghaff
  203.  
  204.                     U.S. Mail                3205 Windsor Ridge Dr.
  205.                                              Westboro MA 01581
  206.                     Telephone                (508) 898-3321 (evenings)
  207.  
  208.           The above are roughly in order of preference (i.e. how quickly
  209.           I'm likely to see your message and be able to respond).  I check
  210.           Channel One almost daily and the other electronic services at
  211.           least weekly in most cases.  In addition, I monitor the Interlink
  212.           Shareware relay on Future Technology and the PCRelay Shareware
  213.           relay on Channel One.
  214.  
  215.           Note 1:
  216.           I can be reached on two Internet nodes:
  217.           1)   gordon_haff@img024.dg.com (or you may need something along
  218.                the lines of gordon_haff%img024.dg.com@relay.cs.net if your
  219.                system doesn't recognize the dg.com domain)
  220.           2)   Alternatively 72561,2637@compuserve.com goes to my
  221.                Compuserve mailbox.  This second method is probably the more
  222.                reliable of the two.
  223.  
  224.           Note 2:
  225.           When contacting me via Compuserve, please use the Easyplex mail
  226.           system since I do not regularly monitor any of the IBM SIG
  227.           message bases.
  228.  
  229.           Directory Freedom 3.50                                     6
  230.  
  231.           1.0  History and Program Philosophy
  232.  
  233.           DF.COM was adapted from Peter Esherick's DC (Directory Control)
  234.           version 1.05B.  DC, in turn, represents a melding of PC
  235.           Magazine's DR and CO utilities (written by Michael J. Mefford and
  236.           published in PC Magazine, vol.6, #17 and #21) with a variety of
  237.           additional features added while not sacrificing the speed and
  238.           compactness of those two utilities.  While DC became a staple in
  239.           my utilities subdirectory, it still lacked a few features which I
  240.           would have found useful.  Some of these were included in Brad
  241.           Stephenson's modifications to DR; others didn't exist at all.
  242.  
  243.           You get the basic idea.  The features I wanted in my directory
  244.           control program were scattered amongst about 3 or 4 different
  245.           versions of the original PC Magazine programs when they existed
  246.           at all.  At the same time, more conventional DOS shells usually
  247.           lacked these features as well plus they tended to be rather big
  248.           clunky things by comparison.
  249.  
  250.           So, what have I added?  Some of the new features are listed
  251.           below.  These are just a sampling but should help to give the
  252.           user of one or more of the earlier programs a flavor for how DF
  253.           has been extended from its original roots.
  254.  
  255.                Directory functions
  256.                User-definable shell functions
  257.                An enhanced display containing more detailed subdirectory
  258.                    information
  259.                Functions to change file and directory attributes
  260.                Increased flexibility in areas such as setting the DOS
  261.                    Verify flag and beep type
  262.                A user-friendly configuration program
  263.  
  264.           Directory Freedom is designed to provide what one user called "a
  265.           rational alternative to the DOS 'dir' command."  While, at this
  266.           stage in its development, DF has grown significantly past the
  267.           point where it merely provides DOS directory services, I have
  268.           tried to stay true to one fundamental philosophy of design.  This
  269.           philosophy is that DF should stay sufficiently small and fast
  270.           that the user does not feel that he is bringing up an
  271.           applications program every time he types "DF".  Rather, it is the
  272.           intent that the user will find it faster and easier to just type
  273.           "DF" that typing DIR, or COPY, or whatever other DOS command is
  274.           required.  Along the way, additional functionality has been
  275.           added, but with the intent of never compromising this basic
  276.           design goal.
  277.  
  278.           Directory Freedom 3.50                                     7
  279.  
  280.           2.0  Installing Directory Freedom
  281.  
  282.           Installing Directory Freedom is straightforward.  If you obtained
  283.           the program from a bulletin board or other source which stores
  284.           all distribution files in a compressed "archive", you first have
  285.           to "de-archive" DF using the appropriate software.  Since you are
  286.           reading this documentation, however, it's a fair bet that you
  287.           have already taken this step!
  288.  
  289.           The next step is to copy the required files to your working
  290.           disk(s).  DF.COM is self-contained and does not require any other
  291.           files for its operation.  DFCONFIG.EXE allows you to easily
  292.           configure DF, however, and you'll want to make use of CONVERT.EXE
  293.           if you are already a DF user and have gone to the time and
  294.           trouble to custom configure an earlier revision of the program.
  295.  
  296.           If you are reasonably familiar with moving files between disks
  297.           and so forth, the following section should tell you all you need
  298.           to know about installing DF.
  299.  
  300.                Quick Installation:
  301.  
  302.           Copy the files DF.COM, (optionally) DFCONFIG.EXE, and
  303.           (optionally) CONVERT.EXE to a working floppy diskette or a
  304.           subdirectory on your hard disk.  If you've got a hard disk, the
  305.           easiest thing is probably just to copy to whatever subdirectory
  306.           you normally keep your utilities in.  Since DF is nice and small
  307.           and simple, there's really no need to go off creating a separate
  308.           subdirectory for it.  To be most useful, whatever subdirectory DF
  309.           ends up in should be part of the PATH setup in your CONFIG.SYS
  310.           file.  You can also go ahead and copy any of the associated
  311.           utilities distributed with DF to the same location if you like
  312.           and do whatever you normally do with the documentation.
  313.  
  314.           If you're already using an earlier (rev 2.20 and later) revision
  315.           of DF, CONFIG.EXE will bring over your customized settings to the
  316.           new revision.  Just type CONVERT at the DOS prompt and follow the
  317.           instructions.  When you're done, go ahead and erase CONVERT.EXE,
  318.           if you like, since you won't be needing it again.
  319.  
  320.           At this, or any other point, you can also run the DFCONFIG
  321.           customization program.  Full instructions for doing this are
  322.           given in Section 5.0 of this manual.
  323.  
  324.           Directory Freedom 3.50                                     8
  325.  
  326.           3.0  Using Directory Freedom
  327.  
  328.           3.1  About this Manual
  329.  
  330.           This documentation was written at a level which, I hope, is
  331.           appropriate to the level of computer sophistication of most DF
  332.           users.  This level assumes a degree of familiarity with keyboard
  333.           usage on an IBM-PC/AT compatible and a basic understanding of how
  334.           DOS is employed to run programs and execute commands.  DF is not
  335.           a DOS Shell in that it attempts to make life easier for the
  336.           person who knows how to use the command line but does not try to
  337.           shield the user from the underlying system.
  338.  
  339.           If the above scares you a bit, don't let it.  We have all been
  340.           beginners at one time and I'm sure you can borrow a book or
  341.           friend who will help you through any rough spots you run into.
  342.           (And feedback on any spots of opaqueness in this manual is always
  343.           welcome as well.)
  344.  
  345.           This manual does go into some depth explaining the hows and whys
  346.           of certain functions.  These explanations exist largely to
  347.           satisfy the curiosity of the more technical users of this program
  348.           and therefore the beginning user should not feel put off if he
  349.           does not understand every concept mentioned in these
  350.           supplementary discussions.
  351.  
  352.           One final note: The commands on the alternate main menu are
  353.           designated throughout this manual as Alt-Fx commands for
  354.           simplicity and consistency with previous revisions of this
  355.           program even though they can now be alternatively defined as
  356.           LeftShift-Fx.
  357.  
  358.           Directory Freedom 3.50                                     9
  359.  
  360.           3.2  Starting up Directory Freedom
  361.  
  362.           The basic format of the DF command line is:
  363.  
  364.                DF [d:][source-path] [d:][dest-path] [/O,N,E,D,or S][/F][/V]
  365.  
  366.           All parameters are optional.  If no pathnames are entered, both
  367.           the source and the destination directories default to the current
  368.           DOS directory.  If only one path is enetered, this path is taken
  369.           to be that of the source directory and the destination directory
  370.           defaults to the current DOS directory.  Options, specified by a
  371.           "/" followed by a letter, may appear either before or after the
  372.           pathnames and override any settings made with the DFCONFIG
  373.           program.  (Pathnames can be a maximum of 63 characters long,
  374.           starting at the drive letter and including the filename.)  The
  375.           options are as follows:
  376.  
  377.           /N   Sort directory by filename
  378.           /E   Sort directory by extension
  379.           /D   Sort directory by date and time
  380.           /S   Sort directory by file size
  381.           /O   Use original order, i.e. do not sort directory at all.
  382.  
  383.           /V   Turn on DOS Verify switch for disk file writes
  384.           /F   Fast display on IBM Color Graphics Adapter (CGA) -- i.e. no
  385.                snow check
  386.  
  387.           DF comes up displaying the "source" / "working" directory.  A
  388.           brief menu of optional commands is displayed to the right of the
  389.           directory display.  You may move up and down the directory list
  390.           with the up and down arrow keys on the cursor keypad.  Files may
  391.           be individually copied, deleted, moved or renamed by pressing the
  392.           function keys F1 through F4, respectively.  Alternatively, a
  393.           number of files may be selected, or "marked" using the Grey + and
  394.           Grey - keys on the right side of the keypad. After marking,
  395.           pressing the appropriate function key will apply the chosen
  396.           operation to the entire group of files.
  397.  
  398.           New directories can be displayed in one of two ways.  You can
  399.           press the F9 function key and enter a new drive and path name.
  400.           Alternatively, if you want to move to different sub-directories
  401.           on the same drive, you simply press the <Enter> key after using
  402.           the up or down arrow keys to high-light the desired subdirectory.
  403.           Note that as always within DOS, ".." denotes the parent of a
  404.           given subdirectory, i.e. the level above the currently displayed
  405.           directory.
  406.  
  407.           Directory Freedom 3.50                                    10
  408.  
  409.           3.3  Key by key Summary of Commands
  410.  
  411.           Esc       Exit program and return to original directory.
  412.  
  413.           Alt-Q     Exit program leaving the currently displayed dir as the
  414.                     current default drive and directory for DOS.
  415.  
  416.           Grey +    Mark current file entry, if not a subdirectory or
  417.           or Ins    hidden file, and advance cursor to next line.
  418.  
  419.           Grey -    Remove mark on current file, and advance cursor to next
  420.           or Del    line.
  421.  
  422.           Space     Same as Grey - (Remove Mark) if currently highlighted
  423.                     file is marked; otherwise same as Grey +
  424.  
  425.           The following functions operate on the marked files, if any,
  426.           otherwise they operate on the currently highlighted file.  If the
  427.           operation is successful the mark is replaced with an asterisk
  428.           (*), if unsuccessful the file is passed over, leaving the mark,
  429.           and the program proceeds on to the next marked file.
  430.  
  431.           F1     Copy file(s) via a read/write sequence to requested target
  432.           F2     Delete file(s) or directory after asking for confirmation
  433.                    (unless empty directory)
  434.           F3     Move file(s), i.e. Copy to requested target, delete 
  435.                    source.  Where possible this function is performed 
  436.                    using an across directory rename instead of a file 
  437.                    read/write sequence.  
  438.           F4     Rename file(s) or directory within the currently 
  439.                    displayed directory.
  440.           F5     Clear all marks 
  441.           F6     Mark all remaining files, i.e. those not marked with an "*"
  442.           F7     Swap marked and unmarked files.
  443.  
  444.           The following three functions change the active source and
  445.           destination directories:
  446.  
  447.           F8     Swap the Working (source) Directory and the Default
  448.                    Destination Directory
  449.           F9     Prompt for a new Working (source) Directory
  450.           F10    Prompt for a new Default Destination Directory
  451.  
  452.           The working (displayed) directory can be re-sorted by typing:
  453.  
  454.           Alt-N  Sort by filename
  455.           Alt-E  Sort by file extension (e.g. .COM vs .DOC)
  456.           Alt-D  Sort by date and time
  457.           Alt-S  Sort by file size
  458.           Alt-O  Re-read and display dir in original, unsorted
  459.                    order
  460.  
  461.           Directory Freedom 3.50                                    11
  462.  
  463.           Additional commands appearing in the ALT menu:
  464.  
  465.           Alt F1    Protected Copy -- similar to F1 except that an error is
  466.                       generated if the target file already exists
  467.           Alt F2    Invoke DOS Shell
  468.           Alt F3    Forced Move -- Unlike a regular move (F3), this option
  469.                       will overwrite the target file if it already exists.
  470.                       (This command has the same relationship to MOVE as 
  471.                       COPY has to PROTECTED COPY.) 
  472.           Alt F4    Re-read working directory.  Required after changing 
  473.                       diskettes in a floppy-disk drive.  Also useful if a 
  474.                       copy or shell command has changed the current directory.  
  475.           Alt F5    Run a program.  Parameters may be added after the 
  476.                       program name.
  477.           Alt F6    Create a directory.  Creates a new subdirectory under
  478.                       the working (displayed) directory using a name 
  479.                       provided by the user.  
  480.           Alt F7    Returns the size of the highlighted directory in terms 
  481.                       of disk space used both on the working drive and on 
  482.                       a typical floppy diskette.
  483.  
  484.           Alt C     Copy (Duplicates F1)
  485.           Alt M     Move (Duplicates F3)
  486.           Alt V     View (Duplicates Return)
  487.  
  488.           Attribute Commands:
  489.  
  490.           Alt A     Add Archive bit
  491.           Alt R     Add Read-Only bit
  492.           Alt H     Add Hidden bit
  493.           Alt Y     Add System bit
  494.  
  495.           Ctrl A    Remove Archive bit
  496.           Ctrl R    Remove Read-Only bit
  497.           Ctrl H    Remove Hidden bit
  498.           Ctrl Y    Remove System bit
  499.  
  500.           Directory Freedom 3.50                                    12
  501.  
  502.           User-defined Commands:
  503.  
  504.           Ctrl-F1 through Ctrl-F10 plus external file viewer.  Ctrl-F11 and
  505.           Ctrl-F12 can be optionally configured through DFCONFIG if you are
  506.           using an extended (101-key or equivalent) keyboard
  507.  
  508.           View Mode commands (ONLY applicable when using internal viewer):
  509.  
  510.           W         Toggle word wrap/horizontal scroll
  511.           A         Toggle ASCII string display
  512.           B         Toggle blanking of non-ASCII characters
  513.           Grey *    Toggle Wordstar bit mask (shift non-ASCII high-order
  514.                       characters (from 128 to 255) down into the 
  515.                       displayable ASCII range of 1 to 127.
  516.  
  517.  
  518.           3.4  File Marking
  519.  
  520.           Entries may be marked, as explained above, with the following
  521.           exceptions.  The marking keys will NOT operate on the following:
  522.  
  523.                --   Subdirectories
  524.                --   Hidden files
  525.  
  526.           Directory Freedom 3.50                                    13
  527.  
  528.           4.0  Program Feature Information
  529.  
  530.  
  531.           4.1  Built-in Viewer
  532.  
  533.           (Note that this section applies ONLY if an external file viewer
  534.           is NOT configured.  I recommend that, for most purposes, the user
  535.           configure Vernon Buerg's LIST as his file viewer.  DF is shipped
  536.           with LIST preconfigured although the user can, of course, change
  537.           this easily, by either changing or deleting the command line LIST
  538.           ~ from within the DFCONFIG program.)
  539.  
  540.           Just as pressing <Enter> lets you view a new directory, pressing
  541.           <Enter> when a filename is highlighted lets you view the contents
  542.           of the file. In the default mode the display is wrapped at the
  543.           edge of the screen if a line is more than 80 characters wide.
  544.           This option can be toggled by pressing W.  Display of non-ASCII
  545.           characters can be toggled with the ASCII and Blank options by
  546.           pressing A or B.  In ASCII mode only strings of 5 or more normal
  547.           ASCII characters (including tab or space) are displayed.  This is
  548.           useful for viewing the messages contained in an .EXE or .COM
  549.           file.  With the Blank option, non-ASCII characters are replaced
  550.           with a blank or space.  A final option, Grey *, masks the high-
  551.           order bit of non-ASCII characters to make Wordstar files
  552.           readable.
  553.  
  554.  
  555.           4.2  Shell functions
  556.  
  557.           These appear in the CONTROL menu with one exception.  The
  558.           exception is the VIEW function accessed by the <Enter> key.  If
  559.           an external VIEW program (such as Buerg's LIST) is defined, it
  560.           will replace the internal VIEW function.  Functions which could
  561.           be set up might include EDIT, UNARCHIVE, and ARCHIVE VIEW.  The
  562.           program comes configured with a few typical external programs
  563.           predefined, but these can be easily added to or changed through
  564.           the use of the DFCONFIG program.
  565.  
  566.           Up to 10 (or 12 if the F11/F12 keys are enabled) external shell
  567.           functions can be assigned to the CONTROL-F1 through CONTROL-F10
  568.           keys.  In addition, an external program can be assigned to the
  569.           VIEW function, as mentioned earlier.
  570.  
  571.           A Run-a-Program function (Alt-F5) allows you to run an executable
  572.           program from within DF.  Use this function with caution, however,
  573.           as detailed further down in this documentation.  The DOS Shell
  574.           (Alt-F2) allows you to temporarily exit to DOS.  You should be
  575.           able to do anything in this shell which you would normally do
  576.           from the DOS command line subject to the contraint that the DF
  577.           parent is using approximately 96KB of memory.  Type 'EXIT' at the
  578.           DOS prompt to return to DF.
  579.  
  580.           Directory Freedom 3.50                                    14
  581.  
  582.           4.3  Attribute Functions
  583.  
  584.           DF incorporates functions which allow you to add or remove file
  585.           attributes.  The ALT-attribute functions allow you to add
  586.           attribute bits while the CTRL-attribute functions allow you to
  587.           remove the bits. The A, R, H, and Y keys control the Archive,
  588.           read-Only, Hidden, and System bits respectively.  (An S-key would
  589.           have conflicted with the sort function, so the system attribute
  590.           was assigned a different key since it will be seldom used
  591.           anyway.)
  592.  
  593.           In general, attribute functions can be performed using standard
  594.           marking just like all other functions.  The exception is un-
  595.           hiding hidden files. Hidden files can be unhid one-by-one, but
  596.           hidden files cannot be marked. This is because the ability to
  597.           mark must carry over to all program functions and I thought that,
  598.           in general, users would want hidden files to be automatically
  599.           skipped when marking files since most functions are not allowed
  600.           on those files by the program.
  601.  
  602.  
  603.           4.4  Notes on RUN a Program
  604.  
  605.            --  Use this option with caution on programs you haven't tried
  606.                out before.  For one thing, DF has no way of testing a
  607.                program's memory requirements.  If a program doesn't do its
  608.                own testing it may hang your system.  Also, some programs
  609.                seem to be allergic to being run in shells.
  610.            --  NEVER execute a Terminate-And-Stay-Resident (TSR) program
  611.                from a shell.  You'll end up creating a hole in memory which
  612.                will, at the least, cause you to lose memory and, at worst,
  613.                will cause a system crash.
  614.  
  615.  
  616.           4.5  DESQView Compatibility
  617.  
  618.           While this revision of Directory Freedom is not fully "DESQview-
  619.           aware," an alternate "hot-key" has been added which can
  620.           substitute for the Alt key.  This addition, in conjunction with
  621.           the following setup information, should allow you to effectively
  622.           use DF in a DESQview environment.
  623.  
  624.           When configuring DESQview to add DF to its program list, the
  625.           following characteristics should be specified in the advanced
  626.           program setup:
  627.  
  628.                Writes directly to screen          Y
  629.                Uses its own colors                Y
  630.                Maximum height/width               25,80
  631.                Starting Row/Column/Height/Width   0,0,25,80
  632.  
  633.           Directory Freedom 3.50                                    15
  634.  
  635.           4.6  Hints and Suggestions
  636.  
  637.           The following techniques, explanations, and hints have proven
  638.           useful to myself or to other users.  They may help you to get
  639.           more out of your copy of Directory Freedom.
  640.  
  641.            --  To "re-mark" a group of files (i.e. mark the same group of
  642.                files which have just been operated on and which now have a
  643.                * next to their entries) press F6 and F7 in sequence.
  644.            --  One of the PC Magazine utilities is called SWEEP and allows
  645.                you to automatically repeat the execution of a command
  646.                through multiple directories.  If you type 'SWEEP DF' from
  647.                the root directory, therefore, DF will be executed in
  648.                succession in each directory on the hard disk.  Ben Stock
  649.                suggests that this "is the best thing for housekeeping,
  650.                reclaiming disk space, and preparing for major backups."
  651.                SWEEP should be available on most major bulletin boards.
  652.            --  To pop up a directory level, highlight the '..' entry and
  653.                press <Enter>.
  654.            --  The DF destination directory is also the current DOS
  655.                directory.  Hence user-defined commands which send output
  656.                files to the default directory regardless of the directory
  657.                of the source file (e.g. PKUNZIP) will send their output to
  658.                the DF default destination directory -- NOT the (displayed)
  659.                working directory.
  660.  
  661.           5.0  Customization
  662.  
  663.           User customization is carried out through the DFCONFIG program
  664.           which is menu driven and includes its own help screens.  You MUST
  665.           use the matching rev of DFCONFIG with DF.  The matching revision
  666.           requirement is enforced by the software and DFCONFIG will give
  667.           you an error message if you attempt to use it to modify a
  668.           mismatched revision of DF.
  669.  
  670.           The DFCONFIG command line is as follows:
  671.  
  672.                DFCONFIG [path\filename of DF]
  673.  
  674.           If you do not specify a path and filename on the DFCONFIG command
  675.           line, DFCONFIG assumes that the program you wish to modify is
  676.           called DF.COM (the name for the Directory Freedom program file as
  677.           shipped) and is in the current directory.  If you do specify a
  678.           path\filename on the command line, you must give a full legal
  679.           pathname from either the current directory or a root and the full
  680.           filename with extension.  (This allows you to rename DF.COM if
  681.           you wish -- always preserve the .COM extension, however, else DOS
  682.           will get confused.)
  683.  
  684.           Miscellaneous DFCONFIG usage notes:
  685.  
  686.            --  A mouse is supported in DFCONFIG's menus.  The <Left Mouse
  687.                Button> button is equivalent to <ENTER> on the keyboard, the
  688.                <Right Mouse Button> button to <ESC>.
  689.  
  690.           Directory Freedom 3.50                                    16
  691.  
  692.            --  If you make changes to DF's parameters, make sure that you
  693.                tell DFCONFIG to save them; i.e. changes are not
  694.                automatically saved.
  695.            --  DFCONFIG operates by reading in DF, making changes to the
  696.                memory image of the program, and then saving the memory
  697.                image back to disk if told to save the changes overwriting
  698.                the original.  This modification procedure may alert certain
  699.                anti-viral programs such as Flushot+.
  700.  
  701.  
  702.           5.1  Commands Modification
  703.  
  704.           DFCONFIG can be used to modify the user-defined shell functions
  705.           accessed by the CONTROL menu in DF.
  706.  
  707.           At the simplest level, the shell functions can merely be used to
  708.           run an external program with no arguments (or at least no
  709.           variable arguments).  Thus, if you had a program called CPUTYPE
  710.           which you would ordinarily run just by typing:
  711.  
  712.                C>CPUTYPE
  713.  
  714.           at the DOS prompt, you would just enter the same thing as one of
  715.           the command lines within the DFCONFIG commands modification
  716.           screen.
  717.  
  718.           There may indeed be situations where you want to access such a
  719.           program from within DF, however this usage does not take full
  720.           advantage of the DF user-defined shell feature.
  721.  
  722.           Since the DF highlight cursor is always resting on a file or
  723.           directory, it might seem useful to be able to pass that
  724.           information to a shell command line.  DF can do exactly this.  By
  725.           entering a ~ (tilde) as part of a defined command line in
  726.           DFCONFIG, the user tells DF to "Insert the full path and filename
  727.           of the file or directory under the highlight at this spot in the
  728.           command."
  729.  
  730.           Along with this feature, beginning with Rev. 3.50, a dynamic
  731.           customization feature has been added.    Together with the ~, a `
  732.           (grave -- the backward accent under the tilde on most keyboards)
  733.           can be added to the command line in DFCONFIG.  If a ` is present
  734.           in the command line, DF will prompt the user for parameters to
  735.           insert at its location at runtime.
  736.  
  737.                Example:
  738.  
  739.           All the above is really a whole lot more complicated to read than
  740.           it actually is to do, so let's go through an example.  Let's
  741.           suppose that we want to define a key for Phil Katz's PKUNZIP
  742.           program which views or extracts the archives found on many
  743.           electronic bulletin board systems.  Although we would normally
  744.           set this program up on two different keys (one to view and one to
  745.  
  746.           Directory Freedom 3.50                                    17
  747.  
  748.           extract), let's assume for the purposes of the example that this
  749.           is a seldom used function and we only want to use one key for it.
  750.  
  751.           We go into DFCONFIG and the Commands menu.  We then enter the
  752.           desired command line.  (We'll assume we've programmed CTRL-F3):
  753.  
  754.           PKUNZIP ` ~
  755.  
  756.           (Enter whatever you like for the menu name -- it's only for your
  757.           own reference.  Don't worry about the Pause? and Refresh? fields
  758.           for now.  They're described later.)
  759.  
  760.           We save the modified data entry screen with a <CTRL-Enter>, and
  761.           choose Save and Quit from the main DFCONFIG menu.
  762.  
  763.           When we next run DF, you'll notice that, when pressing the
  764.           Control key, the new item has been added to the menu.
  765.  
  766.           We now select a file to operate on.  Just move the cursor down
  767.           until the desired file is highlighted and, while holding down the
  768.           Control key, press F3.  DF will prompt you to enter parameters.
  769.           Let's assume you want to view the archive.  In this case, type -v
  770.           and then hit the <Enter> key.  If the highlighted file were
  771.           called ARCHIVE.ZIP and was in the DOWNLOAD directory on the C:
  772.           drive, DF would expand the command line to the following:
  773.  
  774.                PKUNZIP -V C:\DOWNLOAD\ARCHIVE.ZIP
  775.  
  776.                Command-line data entry summary:
  777.  
  778.            --  A tilde (~) indicates that the file name under the cursor is
  779.                to be inserted at that point.  Only one tilde should
  780.                generally be entered per command line, else it may well get
  781.                too long (note that DF uses the filename with its entire
  782.                path)
  783.            --  A grave (`) indicates that a string entered dynamically by
  784.                the user is to be inserted at this point.  More than one
  785.                grave may be entered per command line, BUT the user is only
  786.                prompted for parameters once and this same set of parameters
  787.                will be entered for each grave.
  788.            --  The Pause? value is asking whether you want a "Press any key
  789.                to return" after exiting the program.  You probably don't
  790.                want a pause for things such as editors and do for programs
  791.                which place information on the screen without inserting
  792.                their own pause before exiting.
  793.            --  The Refresh? value is asking whether you want DF to reread
  794.                the directory before returning from the shell.  You will
  795.                generally want to set this value to 'Y' when performing
  796.                functions such as extracting archives.  There is a minimal
  797.                performance penalty attached to performing such a reread on
  798.                hard disks unless the directories are very large.  If a
  799.                function is regularly used on a floppy diskette directory,
  800.                however, you may wish to perform Rereads manually (Alt-F4)
  801.                only when you need them.
  802.  
  803.           Directory Freedom 3.50                                    18
  804.  
  805.            --  In the customization screen, you save your work by either
  806.                typing CTRL-<Enter> at any point, or <Enter> when positioned
  807.                on the last field of the screen.  Exiting with<Esc> DOES NOT
  808.                SAVE THE CONTENTS OF THE SCREEN!
  809.            --  All the movement and edit commands for the data screen are
  810.                available through on-line help in DFCONFIG
  811.  
  812.  
  813.           5.2  Attributes Modification
  814.  
  815.           In addition to DF screen colors (NORMAL, INTENSE, MENU, BORDER,
  816.           and INVERSE), the following attributes can be changed by the
  817.           DFCONFIG program:
  818.  
  819.            --  Switch character         [Default: / (Standard DOS)
  820.            --  Copy Verify mode         [Default: No Change]
  821.            --  Beep tone                [Default: Standard DOS Beep]
  822.            --  Screen snow check        [Default: Off]
  823.            --  Default sort order       [Default: Name order]
  824.            --  Secondary Hot Key        [Default: Alt]
  825.            --  Enable F11/F12 Keys      [Default: No]
  826.  
  827.           Each of these options are explained below.
  828.  
  829.             Color
  830.  
  831.           Both the foreground and background settings of the five color
  832.           combinations used in DF can be modified through DFCONFIG's
  833.           Attribute modification.  To aid you in this process, a sample
  834.           color screen changes dynamically based on the currently set and
  835.           currently highlighted colors.
  836.  
  837.             Switch character
  838.  
  839.                          /    ("Standard" DOS switch) -- Default
  840.                          -    ("Unix" switch)
  841.  
  842.           For the UNIX hackers, the switch character is used to identify an
  843.           option entered on the DOS command line when you first call up DF.
  844.           Normally this is '/', so that options would be specified by /d or
  845.           /o. By changing the byte to '-', options can be entered as -d or
  846.           -o.  This lets you use '/' in your path names, so that instead of
  847.           entering command lines like:
  848.  
  849.                DF C:\COMM\DOWN D:\UTIL /D
  850.  
  851.           You can now enter:
  852.  
  853.                DF C:/COMM/DOWN D:/UTIL -D              or
  854.                DF C:\COMM\DOWN -d D:\UTIL              or
  855.                DF -d  C:/COMM\DOWN D:/UTIL -D
  856.  
  857.           But not:  DF C:\COMM\DOWN D:/UTIL /D    (This will confuse DF)
  858.  
  859.           Directory Freedom 3.50                                    19
  860.  
  861.           (Note that since the confusion results from the option switch,
  862.           and since there are no options entered with pathnames once the
  863.           program is running, you can use either / or \ as a path delimiter
  864.           when entering a destination or changing the path with F9 or F10
  865.           keys.)
  866.  
  867.             Copy Verify option
  868.  
  869.                          No Change
  870.                          Yes
  871.                          No
  872.                          Floppy Only
  873.  
  874.           From the DOS command line, you can type VERIFY ON or VERIFY OFF
  875.           to change DOS's write-verify status.  If Verify is on, MS-DOS
  876.           performs a series of checks following each disk-write operation
  877.           to attempt to verify that the data just written can be read
  878.           without error.  The downside of such checking is that write
  879.           operations are slowed down significantly and the enhanced
  880.           security provided by VERIFY ON is questionable, at least with
  881.           hard disks.
  882.  
  883.           In any case, DFCONFIG allows the write-verify status within DF to
  884.           be set in one of four different ways.  It can be set ON, in which
  885.           case all affected DF commands will operate with write-verify
  886.           status enabled.  It can be set OFF, in which case all affected DF
  887.           commands will operate with write-verify status disabled.  It can
  888.           be set to NO CHANGE, in which case DF will use the write-verify
  889.           status which was in use by DOS prior to running DF.  Or it can be
  890.           set to FLOPPY ONLY in which case verify is set on if the target
  891.           is a floppy diskette and set off otherwise.  Using DF's /V
  892.           command-line switch will force write-verify status ON no matter
  893.           how this switch is set.
  894.  
  895.             Beep option
  896.  
  897.                          DOS Beep
  898.                          Beep 1
  899.  
  900.           If an error is made when using DF (e.g. an illegal operation such
  901.           as deleting a Read-only file is attempted), the program beeps to
  902.           alert you of the error.  By default, the standard DOS beep (ASCII
  903.           07) is used.  Some users find this standard tone rather obtrusive
  904.           and grating on the ear so DFCONFIG allows an alternative "soft
  905.           beep" to be chosen instead.  (This alternative tone is generated
  906.           by programming the timer chip directly instead of using standard
  907.           DOS or BIOS services.  Therefore it may not work on some
  908.           computers which are not 100% IBM PC/AT hardware compatible.)
  909.  
  910.           Directory Freedom 3.50                                    20
  911.  
  912.             Snow Checking
  913.  
  914.                          Yes
  915.                          No
  916.  
  917.           When DF starts up it checks BIOS data area (Segment 40) to see if
  918.           the current display adapter is a monochrome card.  If it isn't
  919.           mono, then DF will query the display adapter before writing a
  920.           character to the display memory to see if it is ok to do so.
  921.           This procedure is necessary to avoid spurious dots or "snow" on
  922.           old IBM Color Graphics Adapters (CGA's) caused by the CPU and the
  923.           display-refresh circuitry simultaneously accessing the video
  924.           buffer.  Unfortunately, this check also slows things down quite a
  925.           bit.  If you prefer speed over a clean display update, or if you
  926.           have an EGA or other color display adapter that doesn't need to
  927.           do this checking, choose OFF for the snow check option.  Choosing
  928.           Yes will enable snow checking on all but the monochrome display
  929.           adapter (which never needs it anyway).  Using DF's /F command-
  930.           line option switch forces snow checking off and will override the
  931.           setting of this switch.
  932.  
  933.             Sort Option
  934.  
  935.                          Name      Ascending order by filename
  936.                          Extension Ascending order by filename extension
  937.                          Size      Descending order by file size in bytes
  938.                          Date      Descending order by file date/time stamp
  939.                          Original  DOS order
  940.  
  941.           A new default sort order can be chosen from within DFCONFIG.  The
  942.           choices (Name, Extension, Size, Date, and Original) are the same
  943.           as those which can be specified on either the DF command line or
  944.           by pressing the appropriate Alt-key.  If a sort order is
  945.           specified as a command line switch, this default setting is
  946.           overridden.
  947.  
  948.           If (O)riginal is chosen, no sort takes place and the filenames
  949.           are displayed in the same order as they are displayed when typing
  950.           the 'dir' command at the DOS prompt.  If (N)ame or (E)xtension is
  951.           chosen, the sort is in ascending (i.e. alphabetical) order.  If
  952.           (S)ize is chosen, the sort is in descending order to allow for
  953.           more efficient packing when copying to multiple floppy diskettes.
  954.           (D)ate also sorts in descending order to place the most recently
  955.           created or modified files at the top of the directory listing.
  956.  
  957.             Secondary Hot Key
  958.  
  959.                          Alt
  960.                          Left-Shift (i.e. the Shift key on the left side of
  961.           the keyboard)
  962.  
  963.           The switch chooses the "hot-key" used to bring up the secondary
  964.           menu of "hardwired" DF functions.  (This is the menu which
  965.           includes the Directory-specific functions and items such as "Run
  966.  
  967.           Directory Freedom 3.50                                    21
  968.  
  969.           a Program.")  The choice is offered because pressing and
  970.           releasing the Alt key also brings up the DESQView menu if
  971.           DESQView is active.  Since Alt has been the secondary "hot-key"
  972.           in all versions of Directory Freedom to date, however, it has
  973.           been left as the default for backward compatibility.
  974.  
  975.             Enable F11/F12 keys
  976.  
  977.                          Yes
  978.                          No
  979.  
  980.           On systems with extended keyboards (101-key or equivalent),
  981.           selecting this option will allow the user to program two
  982.           additional function keys on the Control menu.  The status of this
  983.           switch does NOT affect the ability to program these keys in the
  984.           DFCONFIG command line editor.  Unless this switch is set to Yes,
  985.           however, those programmed keys cannot actually be used (nor will
  986.           they be displayed) within DF.
  987.  
  988.  
  989.           6.0  Supplementary Programs
  990.  
  991.  
  992.           6.1  Included Programs
  993.  
  994.           The programs described in this section are NOT part of DF and are
  995.           distributed with DF only for the convenience of users.  The
  996.           copyrights to this software remain with the original authors.
  997.           Two programs which were included with earlier revs of DF (TED and
  998.           FV) are no longer distributed with DF but they are still
  999.           available from a wide variety of sources.
  1000.  
  1001.             RF
  1002.  
  1003.           I have included a slightly modified version of PC Magazine's
  1004.           RN.COM to provide a higher-level "tree-style" directory program
  1005.           which users can run in conjunction with DF.  It's called RF.COM
  1006.           now and is configured to spawn DF with no switches.  With the
  1007.           addition of directory functions to DF in rev. 3.00, there should
  1008.           now be less need to use RF as a companion program.  This version
  1009.           of RF is based on RN Rev. 2.0 which supports drives >32MB under
  1010.           DOS 4.x.  This will probably be the last major revision of DF to
  1011.           include RF since plans for the next major DF release include a
  1012.           sophisticated support for this functionality (either through a DF
  1013.           Enhanced version or as a separate program.)
  1014.  
  1015.             DFM
  1016.  
  1017.           I have received several requests to add mouse support to DF.
  1018.           While this is still a likely possibility for the future, I didn't
  1019.           add it in rev 3.50.  What I did do, however, was tweak some
  1020.           assembly language sources which derived from PC Magazine's
  1021.           MOUSEKEY program so that they would run properly with DF.  The
  1022.           result is DFM which is a TSR (~900 bytes) which interprets
  1023.  
  1024.           Directory Freedom 3.50                                    22
  1025.  
  1026.           forward/backward mouse movement as up and down keystrokes and
  1027.           which treats the left mouse button as a <Space> (Mark/Unmark) and
  1028.           the right button as an <Enter> (View file or change directory).
  1029.           The mouse sensitivity is adjustable from the command line.  Read
  1030.           the comments at the beginning of the assembly language sources
  1031.           (included) for all the nitty-gritty.  It's not an elegant
  1032.           solution, but it does more or less work.
  1033.  
  1034.             ND
  1035.  
  1036.           This program can be programmed to a function key and will rename
  1037.           the highlighted file to a new name which is derived from the
  1038.           current date. For example, FILENAME.TXT would be renamed to
  1039.           891015.TXT if the date were Oct 15, 1989.  It append a letter to
  1040.           the base name (e.g. 891015A.TXT, 891015B.TXT, etc.) if the "dated
  1041.           name" already exists.  I find this very useful for handling
  1042.           message-base files from BBS's. (Besides, I wrote it and figure
  1043.           that no one can keep me from distributing it with DF if I want
  1044.           to.)
  1045.  
  1046.  
  1047.           6.2  Non-Included Programs
  1048.  
  1049.           The programs in this section are NOT included with the DF
  1050.           distribution, but I have found these programs (or programs
  1051.           fulfilling the same functions) to complement DF well for certain
  1052.           applications.
  1053.  
  1054.             FV or RV
  1055.  
  1056.           Vernon Buerg's FV can be used to cut down on the number of
  1057.           function keys needed to deal with archives.  FV will basically
  1058.           allow you to view any kind of archive (.ZIP, .ARC, etc.) by
  1059.           programming only a single function key.  DF is shipped configured
  1060.           for use with FV.  You'll still need a different function key for
  1061.           each archive extraction function, but consolidating all the view
  1062.           functions should help those users who were running out of keys.
  1063.           Robert T. Kaya's RV serves a similar function.
  1064.                Most recent revisions as of this writing: FV 1.23; RV 2.13
  1065.  
  1066.             SLED or TED or QEDIT or ...
  1067.  
  1068.           Since I do not want to start a religious war, I won't even begin
  1069.           to suggest which editor people should configure.  SLED is a small
  1070.           shareware editor which many people like and is very sophisticated
  1071.           for its size.  TED is a simple editor from PC Magazine which is
  1072.           free copyrighted software.  While lacking such features as word-
  1073.           wrap, it is very compact (~ 12K bytes) and more than sufficient
  1074.           to edit batch files and perform similar tasks.  QEdit is a very
  1075.           good shareware programmers' editor.  Personally, I have my
  1076.           working copy of DF setup to use Multi-Edit (a programmer's
  1077.           editor) and WordPerfect.
  1078.  
  1079.           Directory Freedom 3.50                                    23
  1080.  
  1081.             LIST
  1082.  
  1083.           As mentioned earlier in this documentation, I recommend Vernon
  1084.           Buerg's LIST in place of the built-in file viewer for most
  1085.           applications.  Vernon has been making significant enhancements to
  1086.           LIST recently (current version is 7.3d) and is well worth a look
  1087.           in the event you don't already have a copy.
  1088.  
  1089.  
  1090.           7.0  Technical
  1091.  
  1092.           Compiled using Borland's Turbo Assembler 1.0 and debugged using
  1093.           Turbo Debugger.  Multi-Edit from American Cybernetics was used as
  1094.           an editor. DFCONFIG was compiled using Turbo C 2.0.  Windowing
  1095.           functions in DFCONFIG are from Mike Smedley's CXL rev 5.1.
  1096.  
  1097.  
  1098.           8.0  Acknowledgements
  1099.  
  1100.           DF 1.00 was based extensively on Peter Esherick's source code
  1101.           from DC rev 1.05b with the additional help of some code from Brad
  1102.           Stephenson's DR26 program.  Peter has also been kind enough to
  1103.           share some DC code fixes with me for incorporation into DF.
  1104.           Peter can be contacted at the following:
  1105.  
  1106.                Albuquerque PC Users' Group
  1107.                Albuquerque RBBS  296-7672, John Maio, sysop
  1108.                ARPANET: esheric@SANDIA.GOV
  1109.  
  1110.           I would also like to thank the many users whose suggestions have
  1111.           contributed greatly to the advancement of DF and, of course,
  1112.           those who have registered their copies and made the Shareware
  1113.           concept work.  While the following list is by no means complete,
  1114.           the following individuals' ideas have been especially helpful in
  1115.           my efforts to improve DF: Don Dougherty, Greg Saddler, Tom
  1116.           Bullard, Dennis McCunney, and Jack Lupic.  Finally, I would like
  1117.           to thank the sysops of my "home" BBS (Channel One), Brian Miller
  1118.           and Tess Hedder, and Bud Napier of the Future Technology BBS.
  1119.  
  1120.           Directory Freedom 3.50                                    24
  1121.  
  1122.           9.0  Revision history
  1123.  
  1124.           DF VERSION 3.50
  1125.           General cleanup of shell routines should result in more reliable
  1126.                operation for a wider range of programs (user-defined and
  1127.                Run a Program)
  1128.           Parameters can be inserted at runtime in user-defined functions
  1129.           Optional support for F11/F12 added to user-defined functions
  1130.           Checks added to path length (63 characters max) and length of
  1131.                user command lines when expanded (i.e. file names filled in,
  1132.                etc.) to prevent overruns
  1133.           Menu moved to avoid conflict with long destination path names
  1134.           Information added to display: number of highlighted entry, total
  1135.                number of entries, bytes in subdirectory, and volume name of
  1136.                the working drive
  1137.           Some problems with cursor positioning and other oddities in empty
  1138.                directories, along with cursor problems when deleting
  1139.                directories, eliminated
  1140.           Problems when default directory was deleted eliminated
  1141.           >10MB of tagged files now display properly
  1142.           Internal file viewer finally fixed properly (Thanks to Peter
  1143.                Esherick for sharing his fix in DC  with me)
  1144.           Additional Verify option (ON when copying to floppy only)
  1145.           The left-shift can optionally replace Alt as a hot key for
  1146.                improved interoperability with DESQView
  1147.           Date/Time sorting fixed (Time wasn't sorting in most descending
  1148.                order within a particular date)
  1149.           P-Copy message fixed
  1150.           Major documentation rework.  Also the printed manual is now
  1151.                "desktop publishing quality"
  1152.           Various changes in included programs (for license and other
  1153.                reasons)
  1154.           Message added when shelling to DOS
  1155.           CONVERT has been updated and will also bring over color
  1156.                modifications from earlier revisions
  1157.  
  1158.           DF VERSION 3.01
  1159.           Made modifications to the DOS EXEC functions which should allow a
  1160.                wider range of programs to run from the shell (Control-Fn
  1161.                functions) without problems
  1162.           Eliminated problem with changing to and operating on directories
  1163.                with extensions
  1164.           Corrected problem which caused viewer to PgDn one too many lines
  1165.           Directory attribute changes now work properly
  1166.           Cursor positioning (and associated problems) which occurred when
  1167.                all files in a root directory were deleted is now fixed
  1168.           A potential problem with the Directory Size function which would
  1169.                result in not popping back up to the parent directory if the
  1170.                parent were not sorted at the top of the subdirectory was
  1171.                eliminated
  1172.           The latest FV (1.22) for viewing archives has been added to the
  1173.                DF archive
  1174.  
  1175.           Directory Freedom 3.50                                    25
  1176.  
  1177.           CONVERT has been made more general purpose and can convert either
  1178.                Rev 2.20 or 3.00 to the current rev.  This will be continued
  1179.                with future DF revs
  1180.           DFCONFIG has been relinked with the latest revision of Mike
  1181.           Smedley's CXL function library (5.1).  This should be transparent
  1182.           to the user.
  1183.  
  1184.           DF VERSION 3.00
  1185.           DIRECTORY FREEDOM is now SHAREWARE (fully functional)
  1186.           Added directory functions -- create, size, delete, rename, change
  1187.                attributes
  1188.           Space bar will function as Mark/Unmark for greater consistency
  1189.                with the way other similar programs operate
  1190.           Added a "soft" beep option (configurable in DFCONFIG)
  1191.           Added a Verify On/Off/No Change option (configurable in DFCONFIG)
  1192.           The full path and name for DF.COM can now be specified at the
  1193.                DFCONFIG command line (i.e. the name of DF.COM can be
  1194.                changed and DFCONFIG does not need to run from the same
  1195.                directory)
  1196.           Corrected bug which caused attribute changes to sometimes not
  1197.                "catch" on the first try
  1198.           Moved menu to avoid overwrites by long destination path names
  1199.           Fixed shell bug which could cause DF's attributes to be used by
  1200.                programs run in a shell
  1201.           Added "forced move" option (i.e. a move which will overwrite even
  1202.                if the destination file name already exists)
  1203.           Fixed the wording of the shell return
  1204.           Returns from shell to re-read directory -- cursor will now sit on
  1205.                the original file if it still exists
  1206.           Sort by size order is now sorted in descending order (so that
  1207.                files can be more efficiently copied to multiple diskettes)
  1208.           Added two more auxiliary programs to the archive:
  1209.                Buerg's FV: View all types of archives with one command
  1210.                DFM: A PC Mag MOUSEKEY derivative to allow the use of mouse
  1211.                     movement and mouse buttons with DF
  1212.           Major rewrite of the documentation
  1213.           "Cleanup" of DFCONFIG to warn of exits without saving, etc.
  1214.  
  1215.           DF version 2.20
  1216.           Added some memory management fixes from Peter Esherick to GET_MEM
  1217.                and the MAIN initialization routine
  1218.           Added Reread Directory switch to DF and DFCONFIG
  1219.           Modified DFCONFIG to accommodate significant changes in Michael
  1220.                Smedley's C function libraries (TCXL 3.3 to CXL 5.0)
  1221.           Added mouse support for menu selection to DFCONFIG
  1222.           Added sample color window when configuring DF's colors in
  1223.                DFCONFIG
  1224.  
  1225.           DF version 2.11
  1226.           Fixed problem introduced by longer user-defined command lines in
  1227.                version 2.10.  User functions can now be defined properly.
  1228.  
  1229.           Directory Freedom 3.50                                    26
  1230.  
  1231.           DF version 2.10
  1232.           Fixed shell problem with the CTRL-F5 key (Prompt to continue
  1233.                appeared  before the execution of the shell rather than
  1234.                after)
  1235.           Added configuration (through DFCONFIG) of a default sort option -
  1236.                name, extension, size, date, or original (unsorted)
  1237.           Lengthened allowable command line which can be configured
  1238.  
  1239.           DF version 2.00
  1240.           User defined shell commands are now configured through
  1241.                DFCONF2.EXE   including user defined names for menus and
  1242.                user defined pause after shell execution; environment
  1243.                variables no longer used
  1244.           Attribute modification functions added
  1245.           CONTROL-key menu added to accommodate all this new stuff, along
  1246.                with  other modifications to the existing menus; user-
  1247.                defined commands  are now separate in the CONTROL menu
  1248.           Fixed bug with reading parameters when Running a Program
  1249.  
  1250.           DF version 1.00
  1251.           Alternative ALT-key menu added
  1252.           Shell to List, Edit, Unarc, Unarc view, and run program added
  1253.                with program information specified in environment variables
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.